Jupyter Notebook 下安装 PHP 内核

我最近被强烈安利了 Jupyter Notebook 这个交互式笔记本。然后试用了它自带的 Python 内核后，这个应用整体给我的感觉很不错，就去搜索了下它所支持的其它内核 Jupyter Kernels。我在下面内容介绍下该应用下如何安装 PHP 内核。

安装步骤

安装 PHP 内核 Jupyter-PHP

环境要求

1. PHP >= 7.0
2. 已安装 Jupyter Notebook
3. Mac 上操作

步骤

1. 全局安装 Composer

   $ curl -sS https://getcomposer.org/installer | php
   $ mv composer.phar /usr/local/bin/composer
   

2. 安装 PHP-ZMQ 扩展

   （1) 下载编译

   $ git clone git://github.com/mkoppanen/php-zmq.git
   
   $ cd php-zmq
   
   $ phpize && ./configure
   
   $ make && make install
   

   （2）修改配置

   修改 php.ini 配置，添加 `extension=/path/modules/zmq.so`
   

3. 下载 jupyter-php-installer.phar
4. 执行 phar 安装程序

   $ php jupyter-php-installer.phar install

5. 安装成功，显示 The Jupyter-PHP kernel has been successfully installed.

遇到并解决的问题

问题 1：

编译 PHP-ZMQ 无 autoconf 和 pkg-config

解决：

    $ brew install autoconf
    $ brew install pkg-config

问题 2：

Mac 上无 php.ini

解决：

    $ sudo cp /etc/php.ini.default /etc/php.ini
    

问题 3：

编译的扩展 zmq.so 无法移动到 PHP 默认扩展路径 /usr/lib/php/extensions/no-debug-non-zts-20160303/

解决：

因为 macOS 系统完整性保护（SIP）将阻止你将 zmq.so 移动到默认路径下，而我又不想关闭SIP。所以处理办法是引入扩展写入绝对路径

        
    extension=/path/modules/zmq.so

问题 4：

使用 PHP 内核 并 print 打印出现了双输出

解决：

实际是因为它将打印的值和返回值无差别的输出导致的，而作者暂未解决。查看 issues

问题 5：

安装 php-zmq 扩展报错 ./php_zmq.h:45:10: fatal error: 'php.h' file not found

解决：

问题解决方式参考：unable-to-use-phpize-after-update-to-macos-mojave

    
    # 安装命令行工具
    $ xcode-select --install
    # 安装头文件
    $ sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

问题 6：

安装 jupyter-php-installer.phar 报错 ERROR: Error while trying to download Jupyter-PHP dependencies with Composer.

解决：

原因是 zmq 扩展未安装运行。